home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 049a / copymail.zip / COPYMAIL.DOC < prev    next >
Text File  |  1991-01-22  |  8KB  |  162 lines
  1. CopyMail Version 0.9 (Beta) -- Copyright 1990 by W. F. Muldrow
  2.  
  3.     This program is an original work by W. F. Muldrow (8:928/1@RBBSNet or
  4. 1:3617/1@FidoNet).  Permission is granted to freely distribute unmodified
  5. copies of this program together with its documentation and sample
  6. configuration files so long as no fee is charged for such distribution.
  7. Permission is also granted to use the original program or a modified version
  8. of this program and to incorporate any or all of this program into other
  9. applications so long as no fee is charged for any derivative work.
  10.  
  11.     COPYMAIL is intended for use in multitasking  or multi-node unattended
  12. mailer applications.  It provides the capability of moving outbound mail
  13. packets and bundles which were created in an off-line directory to the
  14. on-line outbound area in a controlled and safe manner.  Multiple nodes are
  15. supported.  Multiple off-line outbound areas are supported in order to
  16. facilitate multi-zone applications.
  17.  
  18.     Copymail uses the Binkley-Term version 2.40 convention of looking for and
  19. creating a flag file (xxxxyyyy.BSY) in the outbound directory to indicate when
  20. it is unsafe to alter outbound files for a node.  To enable this feature in
  21. Binkley-Term, the TaskNumber and Flags configuration verbs should be enabled.
  22. Copymail will also create TASK.xx task flags in Binkley's Flags directory to
  23. help in coordinating multitasking operations.
  24.  
  25.     There are several goals to meet in order to efficiently move mail in
  26. a multitasking and/or multinode environment:
  27.  
  28.         1.  All mailer nodes should be online and ready to answer inbound
  29. calls a maximum amount of time.
  30.  
  31.         2.  All mailer nodes should be able to share common outbound areas
  32. so that callers may receive all available mail by calling any available node.
  33.  
  34.         3.  The mailer must not transmit files which are in use by a mail
  35. processor and the mail processor must not compress packets or update bundles
  36. that the mailer is attempting to send.
  37.  
  38.     CopyMail to the rescue!  All of these goals can be satisfied using
  39. CopyMail together with Binkley-Term 2.40 or later.  It is expected that a
  40. future release of Opus will also allow the same processing method to work.
  41. Here's how it's done:
  42.  
  43.         1.  All mailer nodes are configured to use the same outbound
  44. directories and unique (not shared) inbound files directories.
  45.  
  46.         2.  The mail processor is configured to use a different set of
  47. inbound and outbound directories that are not shared with the mailer(s).
  48.  
  49.         3.  When mail is received by the mailer, it is copied from that
  50. node's inbound files area to the mailer's inbound file area.
  51.  
  52.         4.  If the mail processor is not already active, it is started.
  53. When running under a multitasking environment such as Desqview or Windows,
  54. this involves opening an additional window to allow background processing
  55. of the mail.  In a network environment it may involve a mailer node remaining
  56. off line in order to process mail, but even so, only one node need be off
  57. line to process all of the mail that has been received on any node.
  58.  
  59.         5.  When the mail processor is finished and new outbound mail has
  60. been packed up for the mailer to send, the mail processor's batch file
  61. invokes CopyMail.  CopyMail will happily and safely move the new outbound
  62. mail into the mailer's outbound directory(ies).
  63.  
  64.         6.  After CopyMail has done it's thing, the mail processor's batch
  65. file should check to see if more unprocessed mail has been received.  If
  66. so, return to step 4 and process more mail.  Otherwise, if in a window, the
  67. window can be closed; or if in a network, the node can go back on line.
  68.  
  69.     When copying or combining outbound mail files, an existing outbound
  70. file of CRASH flavor will result in a CRASH outbound file.  Otherwise, any
  71. existing outbound file for the same node address will be converted to the
  72. flavor of the input file.  Outbound compressed mail files will be created
  73. using the current day of the week in the file extension.  Old outbound mail
  74. bundles which have been truncated to zero length will be deleted.
  75.  
  76.     This archive contains the following files:
  77.  
  78.         COPYMAIL.DOC -- This file.
  79.         COPYMAIL.EXE -- Executable program for 8088, 8086, 80186.
  80.         COPYMAIL.286 -- Executable program for 80286, 80386.
  81.         COPYMAIL.CFG -- Sample configuration file.
  82.  
  83.     To run CopyMail, first edit the sample configuration file.  The default
  84. configuration file name is COPYMAIL.CFG.  CopyMail expects to find this file
  85. in the current directory when it is executed.  When running CopyMail, the
  86. following command line should be used:
  87.  
  88.     COPYMAIL [flags] [config-file-name]
  89.  
  90.     The optional flags on the line above may be any of:
  91.  
  92.         /W   -- To override the config file specification and operate in WAIT
  93.                 mode.
  94.         /N   -- To operate in NOWAIT mode.
  95.  
  96.         /S   -- To open files in DOS's "deny none" file sharing mode.
  97.         /C   -- To open files in DOS's "compatibility" mode.  If using
  98.                 COMPATIBLE mode in the config file, it may also be
  99.                 necessary to use this command line flag if you also
  100.                 specify a config file name on the command line.
  101.  
  102.         /O   -- To force the NoOut mode (don't move *.OUT files).
  103.  
  104.         /Tnn -- To override the config file Task number.  nn is a decimal
  105.                 number between 0 and 255.
  106.  
  107.     The optional config-file-name may provide a complete pathname to be used
  108. for the CopyMail configuration file.  This will override the default name of
  109. COPYMAIL.CFG.
  110.  
  111.     All command line and configuration file options may be provided in either
  112. upper or lower case.  Pathnames may use either forward or backward slashes to
  113. divide directory names.  Flags may be preceded by either a forward slash or a
  114. hyphen, and may appear either before or after the configuration file name.
  115.  
  116.     Below, are listed some sample batch file segments which illustrate how
  117. to use CopyMail in a Desqview environment.  DVCOMAND is used to open an
  118. additional Desqview window to process inbound mail.
  119.  
  120. Binkley.Bat:       (mail tossing segment for node 1)
  121.  
  122.     :Toss
  123.     Remark -- If no mail was received, go back online
  124.     if not exist c:\Bink\Node1\*.* Goto Start
  125.     Remark -- Now copy all of the new stuff to the mail processor
  126.     copy c:\Bink\Node1\*.* c:\Mail\Files
  127.     del  c:\Bink\Node1\*.*
  128.     Remark -- Set a flag to show that new mail has arrived
  129.     echo . >c:\Mail\FlagFile.New
  130.     Remark -- If the mail processor is already running, we're done
  131.     if exist c:\Mail\FlagFile.Bsy Goto Start
  132.     Remark -- Otherwise, set the "Active" flag and start the processor
  133.     echo . >c:\Mail\FlagFile.Bsy
  134.     dvcomand open c:\dv\mt-pif.dvp
  135.     goto Start
  136.  
  137. The file MT-PIF.DVP used above is the Desqview program information file that
  138. is used to start the mail batch file shown below.
  139.  
  140. Mail.Bat
  141.  
  142.     :Start
  143.     c:
  144.     cd \Mail
  145.     Remark -- Kill the "New Mail" flag
  146.     del c:\Mail\FlagFile.New
  147.     Remark -- Use QMail to process all of the new mail.
  148.     QM Toss Scan Pack
  149.     Remark -- Use CopyMail to give the mail to the mailer's outbound
  150.     CopyMail
  151.     Remark -- Check to see if more mail came in during processing
  152.     if exist c:\Mail\FlagFile.New Goto Start
  153.     Remark -- Kill the "Active" flag and close the window
  154.     del c:\Mail\FlagFile.Bsy
  155.     exit
  156.  
  157.     Similar use of the "Active" flag can be used to be sure that no mail
  158. is being processed when doing message area maintenance and scanning.  With
  159. only a little work, all routine chores can be handled in the background
  160. leaving nodes on line nearly all of the time.  Using these methods, I have
  161. managed to reduce my offline time to less than 4 percent of the day.
  162.